home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / mspattern.z / mspattern
Encoding:
Text File  |  2002-10-03  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmssssppppaaaatttttttteeeerrrrnnnn((((3333GGGG))))                                                    mmmmssssppppaaaatttttttteeeerrrrnnnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmssssppppaaaatttttttteeeerrrrnnnn - specifies a multisample sample pattern
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd mmmmssssppppaaaatttttttteeeerrrrnnnn((((lllloooonnnngggg ppppaaaatttttttteeeerrrrnnnn))))
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _p_a_t_t_e_r_n   is one of several enumerated values:
  16.  
  17.               MMMMSSSSPPPP____DDDDEEEEFFFFAAAAUUUULLLLTTTT
  18.               MMMMSSSSPPPP____2222PPPPAAAASSSSSSSS____0000
  19.               MMMMSSSSPPPP____2222PPPPAAAASSSSSSSS____1111
  20.               MMMMSSSSPPPP____4444PPPPAAAASSSSSSSS____0000
  21.               MMMMSSSSPPPP____4444PPPPAAAASSSSSSSS____1111
  22.               MMMMSSSSPPPP____4444PPPPAAAASSSSSSSS____2222
  23.               MMMMSSSSPPPP____4444PPPPAAAASSSSSSSS____3333
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      By default multisample samples are located in a cluster surrounding each
  27.      pixel center.  The default locations are chosen to produce an optimal
  28.      result in a single rendering pass.  Higher image quality can be achieved,
  29.      however, if multiple multisample images are composed using the
  30.      accumulation buffer.  To do this effectively, a different sample pattern
  31.      must be used for each rendering pass.  mmmmssssppppaaaatttttttteeeerrrrnnnn allows these different
  32.      patterns to be specified.
  33.  
  34.      Patterns MMMMSSSSPPPP____2222PPPPAAAASSSSSSSS____0000 and MMMMSSSSPPPP____2222PPPPAAAASSSSSSSS____1111 are designed to provide optimal
  35.      results in a 2-pass rendering.  Patterns MMMMSSSSPPPP____4444PPPPAAAASSSSSSSS____0000 through MMMMSSSSPPPP____4444PPPPAAAASSSSSSSS____3333
  36.      provide optimal results in a 4-pass rendering.  In both cases, the images
  37.      resulting from each pass should be accumulated with equal weights.
  38.  
  39.      mspattern should be changed only between complete rendering passes.  It
  40.      should not be changed between the time clear/czclear is called and the
  41.      time that the rendered image is complete.
  42.  
  43.      mmmmssssppppaaaatttttttteeeerrrrnnnn selects the appropriate sample locations as a function of the
  44.      number of samples in the current multisample buffer.  The configuration
  45.      of the multisample buffer should not be changed during the accumulation
  46.      of a single image.
  47.  
  48.      mmmmssssppppaaaatttttttteeeerrrrnnnn is ignored when the multisample buffer is not enabled.
  49.  
  50. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  51.      This example configures the framebuffer with both a multisample buffer
  52.      and an accumulation buffer.
  53.  
  54.           RGBmode();
  55.           doublebuffer();
  56.           acsize(12);
  57.           mssize(4,32,0);
  58.           gconfig();
  59.           lsetdepth(getgconfig(GC_MS_ZMAX),getgconfig(GC_MS_ZMIN));
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmssssppppaaaatttttttteeeerrrrnnnn((((3333GGGG))))                                                    mmmmssssppppaaaatttttttteeeerrrrnnnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74.           zfunction(ZF_GEQUAL);
  75.           zbuffer(TRUE);
  76.           multisample(TRUE);
  77.  
  78.           mspattern(MSP_2PASS_0);
  79.           czclear(0,0);
  80.           /* draw the scene */
  81.           acbuf(AC_CLEAR_ACCUMULATE,1.0);
  82.           mspattern(MSP_2PASS_1);
  83.           czclear(0,0);
  84.           /* draw the scene again */
  85.           acbuf(AC_ACCUMULATE,1.0);
  86.           acbuf(AC_RETURN,0.5);
  87.           swapbuffers();
  88.  
  89. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  90.      msalpha, msmask, mssize, multisample
  91.  
  92. NNNNOOOOTTTTEEEE
  93.      IRIS-4D G, GT, GTX, VGX, and VGXT models, the Personal Iris, Indigo
  94.      Entry, Indy, XL, XS, XS24, XZ, Elan and Extreme systems do not support
  95.      mmmmssssppppaaaatttttttteeeerrrrnnnn.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.